home *** CD-ROM | disk | FTP | other *** search
/ Almathera Ten Pack 3: CDPD 3 / Almathera Ten on Ten - Disc 3: CDPD3.iso / fish / 726-750 / 746 / atbl / atbl.doc < prev    next >
Text File  |  1995-03-18  |  11KB  |  314 lines
  1.                ATbl - Manuel de l'utilisateur
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8. 1. Avertissement
  9.  
  10.     Ce manuel décrit la version 2.20 de l'utilitaire ATbl. Ce  programme
  11. est (c)1991-1992 par Denis GOUNELLE, toute utilisation commerciale ou  vente
  12. sans autorisation écrite est strictement interdite. Vous  pouvez  copier  et
  13. diffuser ce programme aux conditions suivantes :
  14.  
  15.       - l'ensemble des fichiers doit être fourni
  16.       - aucun fichier ne doit avoir été modifié
  17.       - vous ne devez pas demander plus de 40FF pour cela
  18.  
  19.     Malgré de nombreux tests, je ne peux garantir  qu'ATbl  ne  contient
  20. aucune erreur. VOUS UTILISEZ CE PROGRAMME A VOS RISQUES  ET  PERILS.  Je  ne
  21. pourrai en aucun cas être  tenu  responsable  de  tout    dommage,  direct  ou
  22. indirect, résultant de l'utilisation d'ATbl.
  23.  
  24.  
  25. 2. Introduction
  26.  
  27.     ATbl est un programme destiné à permettre la création  de  tableaux.
  28. Il offre trois modes de sortie :
  29.  
  30.     TXT  (mode texte) très laid, mais peut être utile  pour  une
  31.          pré-visualisation ou un test.
  32.     PRT  (mode impression)  résultat  nettement  meilleur,  mais
  33.          votre  imprimante    doit  être  capable  d'imprimer  les
  34.          caractères semi-graphiques IBM.
  35.     IFF  (mode IFF) le meilleur résultat. Vous  pouvez  utiliser
  36.          n'importe   quelle   police   de    caractères    (même
  37.          proportionelle) et choisir la couleur de fond ainsi que
  38.          la couleur d'écriture. Les croisements entre les lignes
  39.          verticales et  horizontales  sont    optimisés  le  mieux
  40.          possible. Le  résultat  est  produit  sous  forme    d'un
  41.          fichier IFF qui peut ensuite être chargé par  n'importe
  42.          quel programme de traitement de texte ou de PAO.
  43.  
  44.     ATbl s'inspire de l'utilitaire "tbl" que l'on trouve  habituellement
  45. sous système UNIX, et d'autres travaux que Guillaume GIROD et moi-même avons
  46. fait. Mon but était de rendre la création de tableaux aussi  simple  que  de
  47. taper les données à mettre dans le tableau. Cela est vrai pour les modes TXT
  48. et IFF, mais pour le  mode  PRT  il  vous  faudra  indiquer  au  moins    deux
  49. paramêtres.
  50.  
  51.     Vous pouvez me faire part de vos remarques ou critiques sur ATbl, en
  52. écrivant à l'adresse suivante:
  53.  
  54.                  M. GOUNELLE Denis
  55.                   Boite 71
  56.                 6, rue des cailloux
  57.                92110 CLICHY - FRANCE
  58.  
  59.     La génération du fichier IFF a été réalisée à  partir  du  programme
  60. "ScreenSaver" parut dans "Amiga News Tech" numéro 24 (juillet/aout 1991).
  61.  
  62.  
  63. 3. Une démo rapide
  64.  
  65.     Appelez votre éditeur de texte favori, et tapez quelques  lignes  de
  66. données, comme par exemple :
  67.  
  68.         Slayer <tab> Seasons In The Abyss <tab> 1990
  69.         <tab> South of Heaven <tab> 1988
  70.         Sepultura <tab> Arise <tab> 1991
  71.         <tab> Beneath The Remains <tab> 1989
  72.         Anthrax <tab> Persistence Of Time <tab> 1990
  73.         Coroner <tab> Mental Vortex <tab> 1991
  74.  
  75. La notation <tab> désigne un  caractère  de  tabulation.  Si  votre  éditeur
  76. remplace les tabulations par des espaces, utilisez plutôt un "/", et ajoutez
  77. la ligne ".tc /" au début du fichier.
  78.     Sauvegardez ce fichier. Lancez ATbl depuis le CLI, en  tapant  "ATbl
  79. <le nom de votre fichier> TXT". Vous obtiendrez alors :
  80.  
  81.         +---------+--------------------+----+
  82.         |  Slayer |Seasons In The Abyss|1990|
  83.         |      |  South of Heaven   |1988|
  84.         |Sepultura|       Arise       |1991|
  85.         |      | Beneath The Remains|1989|
  86.         | Anthrax | Persistence Of Time|1990|
  87.         | Coroner |    Mental Vortex   |1991|
  88.         +---------+--------------------+----+
  89.  
  90. Retournez sous votre éditeur, et ajoutez la ligne  ".ad  llc"  au  début  du
  91. fichier. Sauvez le, et appelez ATbl à nouveau. Le résultat est    maintenant :
  92.  
  93.         +---------+--------------------+----+
  94.         |Slayer   |Seasons In The Abyss|1990|
  95.         |      |South of Heaven     |1988|
  96.         |Sepultura|Arise           |1991|
  97.         |      |Beneath The Remains |1989|
  98.         |Anthrax  |Persistence Of Time |1990|
  99.         |Coroner  |Mental Vortex       |1991|
  100.         +---------+--------------------+----+
  101.  
  102. Dernière manipulation : depuis votre éditeur, ajoutez les  lignes  suivantes
  103. au début du fichier.
  104.  
  105.         .ad css
  106.         Très bons albums
  107.         .nl
  108.  
  109. Sauvegardez le fichier, et appelez ATbl. Voici le résultat :
  110.  
  111.         +-----------------+--------------------+----+
  112.         |          Très bons albums            |
  113.         +-----------------+--------------------+----+
  114.         |Slayer       |Seasons In The Abyss|1990|
  115.         |          |South of Heaven     |1988|
  116.         |Sepultura      |Arise           |1991|
  117.         |          |Beneath The Remains |1989|
  118.         |Anthrax      |Persistence Of Time |1990|
  119.         |Coroner      |Mental Vortex       |1991|
  120.         +-----------------+--------------------+----+
  121.  
  122.  
  123. 4. Manuel
  124.  
  125.     La syntaxe d'appel de ATbl est la suivante :
  126.  
  127.              ATbl entrée {TXT|PRT|IFF} [sortie]
  128.  
  129. Le fichier "entrée" est le fichier à traiter pour produire  un  tableau.  Le
  130. second    argument  indique  le  mode  de  sortie.  Le  fichier  "sortie"  est
  131. facultatif : s'il n'est pas indiqué, la sortie ira sur la sortie standard en
  132. mode TXT et vers l'imprimante en mode PRT, mais en mode IFF aucun fichier ne
  133. sera produit.
  134.  
  135.     Le fichier d'entrée contient à la fois vos données et les paramêtres
  136. de formatage du tableau. Les données sont un ensemble  de  lignes,  avec  le
  137. texte  de  chaque  colonne  séparé  par  une  tabulation  (ce  caractère  de
  138. séparation peut être changé). Les  lignes  verticales  sont  automatiquement
  139. tracées  entre    chaque    colonne.  Les  paramêtres  sont  indiqués  par     des
  140. "requêtes" : ils doivent être placés sur des lignes à part,  commençant  par
  141. un point.
  142.     Voici la liste des requêtes. La chaine entre crochets après  le  nom
  143. des requêtes a la signification suivante :
  144.  
  145.     *    ne peut être utilisée qu'AVANT les lignes de données
  146.     T    utilisée seulement en mode TXT
  147.     P    utilisée seulement en mode PRT
  148.     I    utilisée seulement en mode IFF
  149.  
  150.  
  151. ad  ADjust
  152.     Syntaxe    : ad str
  153.     Description : indique l'ajustement du texte dans  les  colonnes.  Chaque
  154.     caractère de "str" s'applique  à  la  colonne  correspondante,  et  peut
  155.     être :
  156.  
  157.         l        cadré à gauche
  158.         r        cadré à droite
  159.         c        centré
  160.         s        continuation de la colonne précédente
  161.  
  162. an  Auto-Newline
  163.     Syntaxe    : an {0|1}
  164.     Description : active (1) ou  désactive  (0)  la  génération  automatique
  165.     d'une requête ".nl" après chaque ligne de texte
  166.  
  167. as  After String [*P]
  168.     Syntaxe    : as str
  169.     Description : indique la séquence à  envoyer  à  votre  imprimante    pour
  170.     revenir en mode "Amiga". "str" est une suite de codes décimaux,  séparés
  171.     par des espaces.
  172.  
  173. bp  Back Pen [*I]
  174.     Syntaxe    : bp n
  175.     Description : indique la couleur de fond ("n" est un numéro de  registre
  176.     de couleur).
  177.  
  178. bs  Before String [*P]
  179.     Syntaxe    : bs str
  180.     Description : indique la séquence à  envoyer  à  votre  imprimante    pour
  181.     passer en mode "IBM". "str" est une suite de codes décimaux, séparés par
  182.     des espaces.
  183.  
  184. cw  Column Width [*]
  185.     Syntaxe    : cw n m
  186.     Description : force la largeur de la colonne "n" à  "m"  caractères  (ou
  187.     pixels en mode IFF).
  188.  
  189. fp  Front Pen [*I]
  190.     Syntaxe    : fp n
  191.     Description : indique la  couleur  d'écriture  ("n"  est  un  numéro  de
  192.     registre de couleur).
  193.  
  194. ft  FonT [*I]
  195.     Syntaxe    : ft name size
  196.     Description : indique la police à utiliser pour le texte.
  197.  
  198. hl  Horizontal Line
  199.     Syntaxe    : hl car [col]
  200.     Description : indique l'aspect des  lignes  horizontales.  Le  caractère
  201.     "car" peut être :
  202.  
  203.         b        pas de ligne
  204.         -        trait simple
  205.         =        trait double
  206.  
  207.     L'argument "col" (facultatif) est une  suite  de  numéros  de  colonnes,
  208.     séparés par des virgules.  S'il  est  omis,  toutes  les  colonnes  sont
  209.     concernées.
  210.  
  211. lm  Left Margin [*]
  212.     Syntaxe    : lm n
  213.     Description : ajoute une marge gauche de "n" caractères  (ou  pixels  en
  214.     mode IFF).
  215.  
  216. nl  New Line
  217.     Syntaxe    : nl
  218.     Description : trace une ligne horizontale.
  219.  
  220. np  Number of Planes [*I]
  221.     Syntaxe    : np n
  222.     Description : indique le nombre de plans à utiliser pour l'écran.
  223.  
  224. ph  Page Height [*I]
  225.     Syntaxe    : ph n
  226.     Description : indique la hauteur de la page (en pixels).
  227.  
  228. pw  Page Width [*I]
  229.     Syntaxe    : pw n
  230.     Description : indique la largeur de la page (en pixels).
  231.  
  232. tc  Tab Character
  233.     Syntaxe    : tc [car]
  234.     Description : change le caractère séparateur de colonnes. Si  "car"  est
  235.     omis, la valeur par défaut (tab) est reprise.
  236.  
  237. tp  Text Pen [I]
  238.     Syntaxe    : tp n [col]
  239.     Description : indique la couleur à utiliser pour le texte  ("n"  est  un
  240.     numéro de registre de couleur). L'argument "col"  (facultatif)  est  une
  241.     suite de numéros de colonnes, séparés par des virgules. S'il  est  omis,
  242.     toutes les colonnes sont concernées. Notez que la requête  "fp"  modifie
  243.     la couleur de toutes les colonnes.
  244.  
  245. vl  Vertical Line
  246.     Syntaxe    : vl car [col]
  247.     Description : indique l'aspect des lignes verticales. Le caractère "car"
  248.     peut être :
  249.  
  250.         b        pas de ligne
  251.         |        trait simple
  252.         #        trait double
  253.  
  254.     L'argument "col" (facultatif) est une  suite  de  numéros  de  colonnes,
  255.     séparés par des virgules.  S'il  est  omis,  toutes  les  colonnes  sont
  256.     concernées. La colonne 0 est la marge gauche.
  257.  
  258. xx  comment
  259.     Syntaxe    : xx str
  260.     Description : ligne commentaire.
  261.  
  262.  
  263. 5. Le mode IFF
  264.  
  265.     Quand vous demandez le mode IFF, ATbl ouvre un écran dont la  taille
  266. est soit celle indiquée par les requêtes  ".pw"  et  ".ph",  soit  celle  de
  267. l'écran Workbench. Le nombre de plans (et donc de  couleurs)  de  cet  écran
  268. peut être modifié par la requête ".np". Par défaut, il n'y a qu'un plan : le
  269. tableau est donc tracé en couleur 0 sur fond de couleur 1. Les    couleurs  de
  270. tracé et de fond peuvent être modifiées par les  requêtes  ".tp",  ".fp"  et
  271. ".bp".
  272.     Le pointeur souris devient une bulle "Zz", pendant  que  le  tableau
  273. est affiché puis que le fichier IFF est généré. Appuyez sur le bouton gauche
  274. de la souris pour obtenir la page suivante  (si  elle  existe),  ou  sur  le
  275. bouton droit pour quitter.
  276.  
  277.  
  278. 6. Appel depuis le Workbench
  279.  
  280.     ATbl peut être appelé depuis le Workbench. Le  mode  de  sortie  est
  281. alors obligatoirement le mode IFF, et aucun fichier n'est généré.  En  fait,
  282. cette possibilité n'a été ajoutée que pour  permettre  la  visualisation  de
  283. tableau directement depuis le Workbench. Il vous suffit pour cela  de  créer
  284. une icône de type "Project" pour votre  fichier  source,  et  de  mettre  le
  285. chemin d'accès à ATbl dans le champ "Default Tool".
  286.  
  287.  
  288. 7. Historique
  289.  
  290. v1.00    16-Nov-91, 14864 octets (Fish #583)
  291.     o Première version diffusée.
  292.  
  293. v2.00    24-Aug-92, 19324 octets
  294.     o Recompilé avec le SAS/C 5.10b (avec pragmas et optimisation)
  295.     o N'a plus besoin de la "iff.library"
  296.     o De nombreux bugs corrigés (plus  de  problèmes  avec  Enforcer  ni
  297.     Mungwall)
  298.  
  299. v2.10    07-Sep-92, 20760 octets
  300.     o Peut être appelé depuis le Workbench
  301.     o Ajout des requêtes ".an" et ".tp"
  302.  
  303. v2.20    22-Sep-92, 21460 octets
  304.     o Les requêtes ".ph" et ".pw" ne sont plus obligatoires en mode  IFF
  305.     (va chercher les valeurs par défaut dans la structure GfxBase)
  306.     o En mode PRT, si le fichier de sortie n'est pas précisé, le tableau
  307.     est envoyé vers l'imprimante
  308.     o Affiche  la  syntaxe    d'appel  si  pas  d'arguments  ou   en   cas
  309.     d'arguments incorrects
  310.     o Police   "atbl.font"   intégrée   dans   l'exécutable   grâce    à
  311.     "FontConverter" (c)1992 par Andreas Baum.
  312.  
  313.  
  314.